home *** CD-ROM | disk | FTP | other *** search
/ Shareware Grab Bag / Shareware Grab Bag.iso / 090 / ds_200.arc / DS_.DOC next >
Text File  |  1986-04-27  |  31KB  |  770 lines
  1.  
  2.  
  3.   
  4.  
  5.  
  6.  
  7.  
  8.  
  9.  
  10.  
  11.  
  12.  
  13.  
  14.  
  15.  
  16.  
  17.  
  18.                              DIRECTORY SCANNER
  19.  
  20.                                  Ver 2.00
  21.  
  22.                                     by
  23.                              LCDR Nat Martino
  24.  
  25.                         Computer Science Deptartment
  26.                             U. S. Naval Academy
  27.                          Annapolis, MD. 21402-5002
  28.                               (301) 267-2797
  29.  
  30.  
  31.                             after 1 June 1986:
  32.  
  33.                    Pacific Missile Test Center (Code 4002)
  34.                          Point Mugu, CA 93042-5000
  35.                               (805) 989-7535
  36.  
  37.  
  38.  
  39.  
  40.  
  41.  
  42.  
  43.  
  44.  
  45.  
  46.  
  47.  
  48.  
  49.  
  50.  
  51.  
  52.  
  53.  
  54.  
  55.  
  56.  
  57.  
  58.  
  59.  
  60.  
  61.  
  62.  
  63.  
  64.   
  65.  
  66.  
  67.       DS - DIRECTORY SCANNER                           USER'S MANUAL
  68.  
  69.  
  70.       ===================  DIRECTORY MOVEMENT  =====================
  71.  
  72.            The Function Keys F1 thru F8 allow the user to  move  the
  73.       directory  highlighter  from one directory to another.  Moving
  74.       the highlighter from directory to directory  does  not  change
  75.       the  user  into the newly highlighted directory until the user
  76.       strikes the carriage return [CR] key.  The directory  function
  77.       keys do the following:
  78.  
  79.         F1  -  Move  the  directory  highlighter  backward/up to the
  80.         previous directory.
  81.  
  82.         F2 - Move the directory highlighter forward/down to the next
  83.         directory.
  84.  
  85.         F3 - Move the directory highlighter to the root directory.
  86.  
  87.         F4 -  Move  the  directory  highlighter  to  the  very  last
  88.         directory.
  89.  
  90.         F5  -  Move  the  directory  highlighter  to  the  directory
  91.         displayed at the top of the display screen.
  92.  
  93.         F6  -  Move  the  directory  highlighter  to  the  directory
  94.         displayed at the bottom of the display screen.
  95.  
  96.         F7 - Scroll up the display of the directory structure.
  97.  
  98.         F8 - Scroll down the display of the directory structure.
  99.  
  100.                ************      You need to hit the
  101.                * REMEMBER *      carriage return [CR] to
  102.                ************      change/enter a directory.
  103.  
  104.            Currently there is a  limitation  of  a  maximum  of  100
  105.       directories  for  any  one  drive.  Unexpected program actions
  106.       occur with more than 100 directories.
  107.  
  108.       ==================  FILE INDICATOR MOVEMENT  =================
  109.  
  110.            Upon  entering  a  directory  that  contains  one or more
  111.       files,  the first file in the directory is marked with 2 small
  112.       triangluar  indicators,  one  on  each  side of the file name.
  113.       This indicates which file is the current "indicated file", and
  114.       further file information about this file is displayed  at  the
  115.       bottom of the display screen.
  116.  
  117.            To  change  the  "indicated file" the file indicators are
  118.       moved from file to file through the use of  the  cursor  arrow
  119.       keys  on  the numeric keypad.  The arrow and related keys work
  120.       as follows:
  121.  
  122.          Up Arrow Key - Move to the previous file
  123.  
  124.          Down Arrow Key - Move to the next file
  125.  
  126.  
  127.  
  128.                                   - 1 -   
  129.  
  130.  
  131.       DS - DIRECTORY SCANNER                           USER'S MANUAL
  132.  
  133.  
  134.          Left Arrow Key - Move to the file in the column to the left
  135.  
  136.          Right Arrow Key - Move to the file in  the  column  to  the
  137.          right
  138.  
  139.          Home Key - Move to the first file on the display screen
  140.  
  141.          End Key - Move to the last file on the display screen
  142.  
  143.          PgUp Key - Display previous page of file names
  144.  
  145.          PgDn Key - Display next page of file names
  146.  
  147.            The  PgUp/PgDn  keys  are  active only when the currently
  148.       displayed directory has more files than can fit  on  a  single
  149.       screen/page.
  150.  
  151.            Currently there is a limitation of a maximum of 250 files
  152.       per  any one directory.  Unexpected program actions occur with
  153.       more than 250 files per directory.
  154.  
  155.       ========================  COMMANDS  ==========================
  156.  
  157.       ****** ATTRIBUTE TAGGED FILES ******               Option  "A"
  158.  
  159.            This option allows the user to change 3 of the  attribute
  160.       bits  on  all  files  that are tagged.  Depressing "A" with no
  161.       files tagged will result in an error  beep.  Once  files  have
  162.       been tagged this option becomes available.  Activation of this
  163.       option  will  allow the user to turn on/off the read-only bit,
  164.       the system bit and the hidden bit,  by toggling the "r",  "s",
  165.       and "h" keys respectively.  Changing the file's attribute bits
  166.       only  takes  effect when the carriage return key is depressed.
  167.       The user should toggle the attribute select keys ("r",  "s"  &
  168.       "h")  to  the desired states,  then hit the carriage return to
  169.       activate the desired changes.
  170.  
  171.       --------------------------------------------------------------
  172.  
  173.       ******* ATTRIBUTE DIRECTORY ********          Option  "CTRL-A"
  174.  
  175.            This option allows the user to change  the  same  3  file
  176.       attribute  bits  that  Option  A (above) changes,  except this
  177.       option  works  on  the  attribute  bits  of  the   highlighted
  178.       directory.  The  significance  of  changing  the  read-only or
  179.       system bits of a directory is unknown.  Turning the hidden bit
  180.       of a directory on will hide the directory from the normal  DOS
  181.       "dir"   command.   The   DS  program  can  see  the  directory
  182.       regardless of the condition of the hidden bit.  The  user  may
  183.       want  to  hide  a  directory so that other people that use the
  184.       same machine do not  rummage  through  the  hidden  directory.
  185.       This assumes the other users do not know or have access to the
  186.       DS or other programs that show the directory regardless of the
  187.       hidden   bit.   The  user  is  prohibited  from  changing  the
  188.       attribute bits on the root directory of any  drive.  All  sub-
  189.       directories  are  fair  game.
  190.  
  191.  
  192.                                   - 2 -   
  193.  
  194.  
  195.       DS - DIRECTORY SCANNER                           USER'S MANUAL
  196.  
  197.  
  198.  
  199.       --------------------------------------------------------------
  200.  
  201.       *************  BACKUP  *************               Option  "B"
  202.  
  203.            The backup option will execute the "ds_bkup.exe" program.
  204.       It will prompt the user for the type of backup (ie:  to floppy
  205.       disks  or  to  a  second  hard  disk)  and  the  backup  drive
  206.       destination.  It will then present a display screen  identical
  207.       to  the main DS program with the exception that the "indicated
  208.       file" is now marked with only a trailing indicator.  All files
  209.       displayed will have 1 of 3 characters preceeding the filename.
  210.       The 3 characters and their significance are:
  211.  
  212.            "+" indicates the file has its archive bit set,  or  that
  213.                the user would like to set the archive bit on.
  214.  
  215.            [sp]  indicates  the  file  does not have the archive bit
  216.                  set,  or that the user  would  like  to  clear  the
  217.                  archive bit.
  218.  
  219.            "-"  indicates  that  the  user would like to delete this
  220.                 file.
  221.  
  222.           In  the  manual  mode  the  user  is  presented  with  the
  223.       opportunity  to  modify  the archive bit of a file by changing
  224.       the character preceeding the file name.  The actual changes to
  225.       the file's archive bit are  not  implemented  until  the  user
  226.       processes his/her desired changes by hitting the "p" key.  The
  227.       "p"  key  processes changes and will set/clear the archive bit
  228.       on files with "+"/[sp] respectively,  and delete  those  files
  229.       marked with a "-" preceeding the file name.
  230.  
  231.           The  actual  backup  (copying  to  backup) is done only on
  232.       those files that have their archive bit set on.  In the manual
  233.       mode,  the backup of a directory is accomplished by  the  user
  234.       pressing  the "x" key.  The "x" key will eXecute the backup of
  235.       a directory.  If there are no files in the selected  directory
  236.       that  need  backing  up (ie:  no files have their archive bits
  237.       set) then pressing "x" will appear to do nothing,  and you are
  238.       left  in  the same directory to choose additional options.  If
  239.       the directory does need backing up,  then the backup procedure
  240.       will  commence and if the backup is to floppy disks,  the user
  241.       will be prompted to enter the appropriate backup diskettes.
  242.  
  243.           The auto/manual mode refers to the  capability  of  moving
  244.       from directory to directory manually or automatically.  In the
  245.       manual mode, the user must move from one directory to the next
  246.       through the use of the F1-F8 keys and the carriage return.  In
  247.       the  auto  mode,  the backup program automatically moves on to
  248.       the next directory after it  has  completed  operations  in  a
  249.       given  directory.  The user may switch back and forth from the
  250.       manual mode and auto mode through the use of the "m"  and  "a"
  251.       keys.  To  enter  the  auto  mode  from the manual mode simply
  252.       depress the "a" key.  To enter the manual mode from  the  auto
  253.       mode simply depress the "m" key.
  254.  
  255.  
  256.                                   - 3 -   
  257.  
  258.  
  259.       DS - DIRECTORY SCANNER                           USER'S MANUAL
  260.  
  261.  
  262.  
  263.           In  the auto mode,  if a directory requires backup and the
  264.       user is backing up to floppy disks,  the user is prompted  for
  265.       inserting  the  proper  backup  disks.  If  the  user does not
  266.       desire to backup the currently displayed directory,  the  user
  267.       may  skip  that  directory  by  depressing  the  ESC key.  The
  268.       program will then move on to the next directory and check  for
  269.       required  backups.  The  user  is  automatically placed in the
  270.       manual mode at the completion of the auto mode (ie:  when  the
  271.       auto  mode has completed processing the last directory).  Auto
  272.       mode backup to another hard disk does  not  require  prompting
  273.       for backup disks;  however, the user may still be prompted for
  274.       possible obsolete backup files (see below).
  275.  
  276.       The  backup  program maintains 3 user selectable copy options.
  277.       They are:
  278.  
  279.             Precautionary Copy - A precautionary copy is the copy to
  280.       backup of a file which did not have its archive bit  set.  The
  281.       file  is  copied to backup even though the archive bit was not
  282.       on as a precaution because the backup program could not find a
  283.       file by the same name on any  of  the  backup  disks  for  the
  284.       current directory.  The default for this option on start up is
  285.       "yes"  do precautionary copying of files where necessary.  For
  286.       this option to work correctly, the user must insert all backup
  287.       disks for a particular directory  in  the  correct  sequential
  288.       order.
  289.  
  290.             Obsolete Backups - An obsolete backup file is a file the
  291.       program finds on a backup disk but does not find a file by the
  292.       same name in the directory which the user is backing  up.  The
  293.       default  for  this  option  on start up is "identify" possible
  294.       obsolete files.
  295.  
  296.             Delete Duplicate Backups - Duplicate backups are 2 files
  297.       on 2 different backup floppy diskettes  of  1  directory  that
  298.       have  the  same name.  The default for this option on start up
  299.       is "no",  do not  delete  duplicate  backup  files.  For  this
  300.       option  to  work  correctly,  the  user must insert all backup
  301.       disks for a particular directory  in  the  correct  sequential
  302.       order.
  303.  
  304.           All 3 of the above copy options can be changed by the user
  305.       by  selecting  the  "d" (for defaults) key,  and then toggling
  306.       either the "p",  "o"  or  "d"  keys  for  Precautionary  Copy,
  307.       Obsolete Backups, and Duplicate Backups respectively.
  308.  
  309.          One of the options available while in the  manual  mode  is
  310.       the "Restore-.bat" option.  This option will construct, in the
  311.       root  directory  of  the drive to be backed up,  2 batch files
  312.       that can be used to reconstruct the  directory  structure  and
  313.       restore all backup files, should the need to reformat the hard
  314.       disk become necessary or should the user desire to switch over
  315.       to a new hard disk.  If you are backing up to floppies,  the 2
  316.       files are "ds_f1.bat" and "ds_f2.bat".  If you are backing  up
  317.       to  a  second  hard  disk,   the  files  are  "ds_h1.bat"  and
  318.  
  319.  
  320.                                   - 4 -   
  321.  
  322.  
  323.       DS - DIRECTORY SCANNER                           USER'S MANUAL
  324.  
  325.  
  326.       "ds_h2.bat".  This option should be  executed  each  time  the
  327.       user makes some sort of change to the directory structure (ie:
  328.       mkdir/rmdir) on the hard disk in question.
  329.  
  330.       --------------------------------------------------------------
  331.  
  332.       *********  COMMAND ENTER  **********               Option  "C"
  333.  
  334.           The  command  entry  option  allows  the user to enter any
  335.       command they would enter at the  normal  DOS  command  prompt.
  336.       Whatever  is entered by the user is passed on to a second copy
  337.       of "command.com".  Upon completion  of  the  command,  the  DS
  338.       program  resumes.  This  option  allows the user to start up a
  339.       second command processor by issuing the command "command".  To
  340.       terminate the second  command  processor  the  "exit"  command
  341.       would be given.
  342.  
  343.  
  344.       --------------------------------------------------------------
  345.  
  346.       *******  COPY TAGGED FILES  ********           Option  "Alt-C"
  347.  
  348.           The  copy  tagged files option  will copy those files that
  349.       are tagged (see Option "T" below) to  a  specified  directory.
  350.       The  user  will specify the desired destination directory.  If
  351.       the user desires to make a second copy of a file in  the  same
  352.       directory, specify only the new name of the file.  If the user
  353.       specifies only a drive specification such as "a:", the program
  354.       will  copy  the  tagged files to the current directory on that
  355.       drive.  If the user does not specify a  destination  directory
  356.       but simply enters a carriage return, the program will copy the
  357.       tagged  files to the directory which is currently highlighted.
  358.       When choosing this last method of specifying  the  destination
  359.       directory,  prior to entering the carriage return the user may
  360.       change the highlighted directory with the use of the  F1  thru
  361.       F8  keys.  The  program will not allow the user to copy a file
  362.       or files to  the  same  directory  without  specifying  a  new
  363.       filename.  In other words, no copy will take place if the user
  364.       simply  enters a carriage return and the highlighted directory
  365.       also happens to be the current  directory.  This  prevents the
  366.       system from trying to copy a file onto itself and consequently
  367.       clobbering itself.
  368.  
  369.  
  370.       --------------------------------------------------------------
  371.  
  372.       **********  DRIVE CHANGE  **********               Option  "D"
  373.  
  374.           The  drive  change  option  allows the user to switch to a
  375.       different default drive and display  the  directory  structure
  376.       information of the new drive.  When switching off a hard disk,
  377.       all directory structure information about that drive and other
  378.       pertinent  program  information (ie:  current colors) is first
  379.       copied to the device driver  "ds_drive.sys"  memory  location.
  380.       This  is done so that when switching back to that hard disk it
  381.       is not necessary to do the lengthy disk I/O process to recover
  382.  
  383.  
  384.                                   - 5 -   
  385.  
  386.  
  387.       DS - DIRECTORY SCANNER                           USER'S MANUAL
  388.  
  389.  
  390.       the disk directory structure information.
  391.  
  392.       --------------------------------------------------------------
  393.  
  394.       ******  DELETE TAGGED FILES  *******           Option  "Alt-D"
  395.  
  396.           The  delete  tagged  files  option  will allow the user to
  397.       delete those files that  have  been  tagged  (see  Option  "T"
  398.       below).  This  option  will  first request a confirmation that
  399.       the user really wants to delete all those  files  marked.  The
  400.       default  confirmation  response is "Y",  so depressing any key
  401.       except "N" (and ESC) will delete all tagged files.
  402.  
  403.       --------------------------------------------------------------
  404.  
  405.       ********  DIRECTORY RESCAN  ********         Option  "Cntrl-D"
  406.  
  407.           The directory rescan  option  will  rescan  the  directory
  408.       structure  of  the current default drive.  This option will be
  409.       necessary if you switch floppies in a floppy drive,  or add or
  410.       delete  directories  on  a  hard  disk  while executing the DS
  411.       program.  This option can be used in place of exiting  the  DS
  412.       program  and  re-entering  it  with  "ds  c" to rescan the "c"
  413.       drive.
  414.  
  415.       --------------------------------------------------------------
  416.  
  417.       ******  EDIT INDICATED FILE  *******               Option  "E"
  418.  
  419.           The edit option will allow the user to  edit  the  current
  420.       "indicated  file".  The  user  must have a file (your favorite
  421.       editor) by the name of "edit.com" or "edit.exe" in your  path.
  422.       The DS program does not provide an editor, but simply attempts
  423.       to  execute  a  .com or .exe file by the name of "edit" and if
  424.       successful,  passes to it the name of  the  current  indicated
  425.       file.  Upon termination of the editing process, the DS program
  426.       resumes where it left off.
  427.  
  428.       --------------------------------------------------------------
  429.  
  430.       ***********  FIND FILE   ***********               Option  "F"
  431.  
  432.          The find option will allow the user to search  the  current
  433.       default  drive  for  a  specified file.  The user provides the
  434.       name of the file,  which can include the "*" and "?"  wildcard
  435.       specifiers.  The  find  option  will then commence a search of
  436.       all directories starting  from  the  root  directory.  When  a
  437.       matching  file  is found in a directory,  the program stops in
  438.       that directory and  displays  the  files  of  that  directory.
  439.       Additionally,  the  matching  file  will  become  the  current
  440.       "indicated file".  This option only finds the  first  matching
  441.       file  in  the  directory.  If  there are additional files that
  442.       match  (which  is  likely  with  "*"  and  "?")  in  the  same
  443.       directory, the user must spot these additional files visually.
  444.       Additionally, the   first   matching   "indicated   file"  may
  445.       not  be  listed alphabetically first.
  446.  
  447.  
  448.                                   - 6 -   
  449.  
  450.  
  451.       DS - DIRECTORY SCANNER                           USER'S MANUAL
  452.  
  453.  
  454.          Once the program has halted  in  a  directory  that  has  a
  455.       matching file the following options are available:
  456.  
  457.           Arrow Keys   \
  458.           Home / End    }  -   Work as they normally do
  459.           PgUp / PgDn  /
  460.  
  461.           'L' or 'l' Key   -   Will list the indicated file
  462.  
  463.           Note: Directory movement keys F1-F8 do not work here.
  464.  
  465.       The user has 3 additional options to continue/terminate:
  466.  
  467.           Esc Key  -  Continue searching directories
  468.  
  469.           F9  Key  -  Terminate search option in the currently
  470.           displayed directory.
  471.  
  472.           F10 Key  -  Terminate search option in the directory from
  473.           which the search option was started.
  474.  
  475.       If  Esc is chosen,  upon completion of the final directory the
  476.       user is placed in the original directory from which  the  find
  477.       option was activated.
  478.  
  479.       --------------------------------------------------------------
  480.  
  481.       ***********  HELP MENU  ************               Option  "?"
  482.  
  483.           The help menu  will  print  a  one  page  summary  of  all
  484.       available options.
  485.  
  486.       --------------------------------------------------------------
  487.  
  488.       ***********  LIST FILE   ***********               Option  "L"
  489.  
  490.          The list option will allow the user to list the contents of
  491.       the current "indicated file".  The user  should  have  a  file
  492.       (your  favorite  lister  program) by the name of "list.com" or
  493.       "list.exe" in your path.  If neither  file  is  found  in  the
  494.       path,  the  indicated  file  will be listed via the DOS "type"
  495.       command.  An outstanding lister program by Vernon D.  Buerg is
  496.       provided  with  this  program for your evaluation.  Should you
  497.       find it of use you are encouraged  to  show  your appreciation
  498.       with a financial contribution to Mr. Buerg.
  499.  
  500.       --------------------------------------------------------------
  501.  
  502.       *******  MOVE TAGGED FILES  ********               Option  "M"
  503.  
  504.           The move tagged files option allows the user to move those
  505.       files  tagged  (see  Option "T" below) to another directory on
  506.       the SAME drive.  Moving files from directory to  directory  is
  507.       quicker and more efficient than copying all the  tagged  files
  508.       to  the  destination  directory and then deleting all the same
  509.       files from the source directory.  The user can either  specify
  510.  
  511.  
  512.                                   - 7 -   
  513.  
  514.  
  515.       DS - DIRECTORY SCANNER                           USER'S MANUAL
  516.  
  517.  
  518.       the  desired  destination directory or enter simply a carriage
  519.       return.  If the  user  enters  only  a  carriage  return,  the
  520.       program  will move all the tagged files to the directory which
  521.       is  currently  highlighted.   When  choosing  this  method  of
  522.       specifying the destination directory,  the user may change the
  523.       highlighted directory with  the  F1  thru  F8  keys  prior  to
  524.       entering  the carriage return.  Additionally,  the highlighted
  525.       directory must be different from the  current  directory  (the
  526.       one  in  which  the  tagged  files  are in) for this method of
  527.       entering only a carriage return to work.
  528.  
  529.       --------------------------------------------------------------
  530.  
  531.       ******  PRINT TAGGED FILES  ********               Option  "P"
  532.  
  533.           The print tagged files option allows the user to  send  to
  534.       the  print  spooler a maximum of 10 tagged files.  This option
  535.       simply sends to the standard DOS "print" command the first  10
  536.       tagged  files.   Once  sent  to  the  print  spooler,   it  is
  537.       recommended that you exit the DS program completely to enhance
  538.       or increase the speed of printing the desired  files.  If  the
  539.       user  remains  in  the  DS program,  the speed of printing the
  540.       files is drastically reduced as the print spooler must compete
  541.       with the DS program for cycle time.
  542.  
  543.       --------------------------------------------------------------
  544.  
  545.       **********  RENAME FILE  ***********               Option  "R"
  546.  
  547.           The rename option allows the user to rename the indicated
  548.       file to a new name.
  549.  
  550.       --------------------------------------------------------------
  551.  
  552.       ********  SCREEN REFRESH  **********               Option  "S"
  553.  
  554.           The  screen  refresh  option will allow the user to redraw
  555.       the entire screen.  This may become  necessary  should  a  DOS
  556.       message like "Abort, Retry or Ignor" disrupt the screen.
  557.  
  558.       --------------------------------------------------------------
  559.  
  560.       ***********  TAG FILE  *************               Option  "T"
  561.  
  562.           The  tag  file  option  is  used  as  a precursor to other
  563.       options such as  the  copy  tagged  files  option.  When  this
  564.       option  is  selected,  the  current  indicated  file is set to
  565.       reverse video and the next file becomes the current  indicated
  566.       file.
  567.  
  568.  
  569.  
  570.  
  571.  
  572.  
  573.  
  574.  
  575.  
  576.                                   - 8 -   
  577.  
  578.  
  579.       DS - DIRECTORY SCANNER                           USER'S MANUAL
  580.  
  581.  
  582.       --------------------------------------------------------------
  583.  
  584.       *********  TAG ALL FILES  **********           Option  "Alt-T"
  585.  
  586.           The  tag  all  files option allows the user to tag all the
  587.       files in the current directory in preparation for execution of
  588.       another option.
  589.  
  590.       --------------------------------------------------------------
  591.  
  592.       **********  UNTAG FILES  ***********               Option  "U"
  593.  
  594.           The  untag option allows the user to untag a file that has
  595.       been tagged by mistake.
  596.  
  597.       --------------------------------------------------------------
  598.  
  599.       ********  UNTAG ALL FILES  *********           Option  "Alt-U"
  600.  
  601.           The untag all files option allows the user  to  untag  all
  602.       the files that are currently tagged.
  603.  
  604.       --------------------------------------------------------------
  605.  
  606.       *********  EXECUTE FILE  ***********               Option  "X"
  607.  
  608.           The eXecute file option allows the  user  to  execute  the
  609.       current  indicated  file if its file name extension is ".com",
  610.       ".exe",  ".bat",  or  ".bas".   Files  with  a  .com  or  .exe
  611.       extension  are executed directly.  Files with a .bat extension
  612.       are submitted to a secondary command processor.  Files with  a
  613.       ".bas" extension are passed as a parameter to the execution of
  614.       a file by the name of "basica.exe".  Prior to the execution of
  615.       any  of  these  files,  this  option  allows the user to enter
  616.       command line arguments  which  are  passed  to  the  indicated
  617.       program as it goes into execution.
  618.  
  619.  
  620.       ======================  COLOR CHANGES  =======================
  621.  
  622.          The DS program will allow the user  with  a  color/graphics
  623.       monitor to change the color of the foreground,  background and
  624.       display border.  The following keys are used:
  625.  
  626.          Grey "+" Key  - Change/Increment the display foreground
  627.                          color.  The foreground cycles thru  16
  628.                          colors.
  629.  
  630.          Grey "-" Key  - Change/Increment the display background
  631.                          color.  The background cycles thru 8
  632.                          colors.
  633.  
  634.          Delete Key    - Change/Increment the display border color.
  635.                          The border cycles thru 8 colors.
  636.  
  637.            Color changes should be done while the default drive is a
  638.  
  639.  
  640.                                   - 9 -   
  641.  
  642.  
  643.       DS - DIRECTORY SCANNER                           USER'S MANUAL
  644.  
  645.  
  646.       hard disk so that when switching drives  the  colors  will  be
  647.       retained.  The  color  information  is written/retained in the
  648.       device driver "ds_drive.sys" memory area when shifting off the
  649.       hard disk.  If the user exits DS and then activates it  again,
  650.       the  old colors (from the previous session of DS) will be read
  651.       from the "ds_drive.sys"  memory  area  and  used  in  the  new
  652.       session.
  653.  
  654.            The initial  start  up  colors  of  the  DS  display  are
  655.       determined in one of two ways.
  656.  
  657.            1)  The  user  specifies a "set DS=0F14" statement in the
  658.       environment (most  appropriately  in  the  autoexec.bat  file)
  659.       prior  to initial execution of the program.  The set statement
  660.       will place the 'DS' variable into the environment for  program
  661.       access.  The 'DS' variable is formatted as follows:
  662.  
  663.           DS=rFBb      where  r  F  B  b  represent:
  664.             |||||
  665.             |||||- border color (0 - 7)
  666.             ||||-- Background Color (0 - 7)
  667.             |||--- Foreground Color (0 - F hex)
  668.             ||---- Recursion Level Indicator (always 0 )
  669.             |----- no spaces in variable definition
  670.  
  671.          Colors are specified as follows:
  672.  
  673.             0 = Black      8 = Gray
  674.             1 = Blue       9 = Light Blue
  675.             2 = Green      A = Light Green          -\
  676.             3 = Cyan       B = Light Cyan              \   Must
  677.             4 = Red        C = Light Red                 \ be
  678.             5 = Magenta    D = Light Magenta             / Upper
  679.             6 = Brown      E = Yellow                  /   Case
  680.             7 = White      F = High-intensity White -/
  681.  
  682.          Example:
  683.              set DS=0F14     will set foreground to Hi White  (F)
  684.                                       background to Blue      (1)
  685.                                    &  border to Red           (4)
  686.  
  687.           The easiest way to determine  the  correct  parameters  to
  688.       enter  with  the  "set  DS=0xxx"  command  is  to activate the
  689.       program,  cycle through the colors with '+' '-' and <bs> until
  690.       you have the colors you want,  then depress the CNTRL and HOME
  691.       keys simultaneously.  The "Cntrl-Home" option  will  show  you
  692.       the  correct  parameters  to  enter for the currently selected
  693.       colors.
  694.  
  695.  
  696.            2) If the user does not place the 'DS'  variable  in  the
  697.       environment as described above,  the foreground and background
  698.       display colors will be the default colors in use at  the  time
  699.       the  DS  program  is  initially executed.  The border color is
  700.       choosen by the program to ensure it does not conflict with the
  701.       foreground or background colors.
  702.  
  703.  
  704.                                   - 10 - 
  705.  
  706.  
  707.       DS - DIRECTORY SCANNER                           USER'S MANUAL
  708.  
  709.  
  710.  
  711.  
  712.           Upon exiting the DS program the DOS  default  colors  that
  713.       were  in  use  prior  to  the execution of DS are reactivated.
  714.       Should the user desire to change the DOS default colors  prior
  715.       to exiting the DS program, the user can select the "Cntrl-End"
  716.       option.  The  "Cntrl-End" option will allow the user to retain
  717.       the current DS program colors  upon  returning  to  DOS.  This
  718.       option  requires  the  "ansi.sys"  device  driver to have been
  719.       installed at power up.
  720.  
  721.  
  722.       =======================  EXIT OPTIONS  =======================
  723.  
  724.           Two exit options are available:
  725.  
  726.           F9 -  Exit in the directory that is currently highlighted.
  727.  
  728.           F10 - Exit in the directory from which the DS program was
  729.                 originally started.
  730.  
  731.  
  732.  
  733.  
  734.  
  735.  
  736.  
  737.  
  738.  
  739.  
  740.  
  741.  
  742.  
  743.  
  744.  
  745.  
  746.  
  747.  
  748.  
  749.  
  750.  
  751.  
  752.  
  753.  
  754.  
  755.  
  756.  
  757.  
  758.  
  759.  
  760.  
  761.  
  762.  
  763.  
  764.  
  765.  
  766.  
  767.  
  768.                                   - 11 - 
  769.  
  770.